Anforderung: credentials-Eigenschaft
Baseline Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since March 2017.
Hinweis: Diese Funktion ist in Web Workers verfügbar.
Die schreibgeschützte credentials-Eigenschaft der Request-Schnittstelle spiegelt den Wert wider, der im Request()-Konstruktor in der credentials-Option angegeben wurde. Sie bestimmt, ob der Browser Anmeldedaten zusammen mit der Anfrage sendet, sowie ob jegliche Set-Cookie-Antwort-Header beachtet werden.
Anmeldedaten sind Cookies, TLS-Client-Zertifikate oder Authentifizierungs-Header, die einen Benutzernamen und ein Passwort enthalten.
Weitere Details finden Sie unter Anmeldedaten einschließen.
Wert
Ein String mit einem der folgenden Werte:
omit-
Niemals Anmeldedaten in der Anfrage senden oder in der Antwort einschließen.
same-origin-
Nur Anmeldedaten für Anfragen gleicher Herkunft senden und einschließen. Dies ist die Standardeinstellung.
include-
Immer Anmeldedaten einschließen, auch bei Anfragen von anderer Herkunft.
Beispiele
Im folgenden Codeausschnitt erstellen wir eine neue Anfrage mit dem Request()-Konstruktor (für eine Bilddatei im selben Verzeichnis wie das Skript) und speichern dann die Anmeldeinformationen der Anfrage in einer Variablen:
const request = new Request("flowers.jpg");
const credentials = request.credentials; // returns "same-origin" by default
Spezifikationen
| Specification |
|---|
| Fetch # ref-for-dom-request-credentials② |